package com.example.meservice.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.meservice.domain.dto.rechargeDTO;
import com.example.meservice.domain.entity.User;
import com.example.meservice.domain.entity.coupon;

import java.util.List;

/**
 * 用户个人中心服务接口
 * 定义用户信息管理、登录认证、充值及优惠券等核心业务操作
 *
 * @author czwa
 */
public interface IMeService extends IService<User> {

    /**
     * 用户登录认证
     *
     * @param user 包含手机号和密码的用户对象
     * @return 认证成功的用户信息
     * @throws RuntimeException 当认证失败时抛出
     */
    User login(User user);

    /**
     * 获取当前用户信息
     *
     * @return 用户信息实体
     */
    User getMe();

    /**
     * 添加充值订单记录
     *
     * @param amount 充值金额
     */
    void addRechargeOrder(double amount);

    /**
     * 获取用户充值订单列表
     *
     * @return 充值订单DTO列表
     */
    List<rechargeDTO> getRechargeOrder();

    /**
     * 根据ID更新用户信息
     *
     * @param user 包含待更新信息的用户实体
     */
    void updateInformationById(User user);

    /**
     * 获取用户已领取的优惠券数量
     *
     * @return 优惠券数量
     */
    Integer getCouponCount();

    /**
     * 获取用户已领取的优惠券列表
     *
     * @return 优惠券实体列表
     */
    List<coupon> getMyCoupon();

    /**
     * 检查并更新用户状态
     * 包括等级升级和奖励发放逻辑
     *
     * @param currentId 当前用户ID
     */
    void checkAndUpdate(Integer currentId);
}